#オプション

#オプションの解決

オプションは、コンテキスト依存のルートを使用して上から下に解決されます。

#チャートレベルのオプション

  • オプション
  • オーバーライド[config.type
  • デフォルト

#データセットレベルのオプション

dataset.typeデフォルトはconfig.type指定されていない場合は、

  • データセット
  • オプション.データセット[dataset.type
  • オプション
  • オーバーライド[config.type].データセット[dataset.type
  • デフォルト.データセット[dataset.type
  • デフォルト

#データセットのアニメーション オプション

  • データセット.アニメーション
  • オプション.データセット[dataset.type]。アニメーション
  • オプション.アニメーション
  • オーバーライド[config.type].データセット[dataset.type]。アニメーション
  • デフォルト.データセット[dataset.type]。アニメーション
  • デフォルトのアニメーション

#データセット要素レベルのオプション

各スコープは次のように検索されます。elementType最初にオプション名の接頭辞を付けてから、接頭辞を付けません。例えば、エビード07-2b53-47e7-9326-295f8d7f2463ためにpoint要素は次を使用して検索されますpointRadiusそれがヒットしない場合は、radius

  • データセット
  • オプション.データセット[dataset.type
  • オプション.データセット[dataset.type].要素[elementType
  • オプション.要素[elementType
  • オプション
  • オーバーライド[config.type].データセット[dataset.type
  • オーバーライド[config.type].データセット[dataset.type].要素[elementType
  • デフォルト.データセット[dataset.type
  • デフォルト.データセット[dataset.type].要素[elementType
  • デフォルト.要素[elementType
  • デフォルト

#スケールオプション

  • オプション.スケール
  • オーバーライド[config.type].スケール
  • デフォルトのスケール
  • デフォルトのスケール

#プラグインオプション

プラグインが提供できるのは、additionalOptionScopesさらにオプションを検索するためのパスの配列。ルート スコープには、空の文字列を使用します。''。ほとんどのコア プラグインは、ルート スコープからオプションも取得します。

  • オプション.プラグイン[plugin.id
  • (オプション。[...plugin.additionalOptionScopes])
  • オーバーライド[config.type].プラグイン[plugin.id
  • デフォルト.プラグイン[plugin.id
  • (デフォルト。[...plugin.additionalOptionScopes])

#スクリプト可能なオプション

スクリプト可能なオプションは、基礎となるデータ値ごとに呼び出され、一意の引数を取る関数も受け入れます。contextコンテキスト情報を表す (「オプションコンテキスト)。 リゾルバーは 2 番目のパラメーターとして渡され、同じコンテキスト内の他のオプションにアクセスするために使用できます。

ノート

context関数はさまざまなコンテキストで呼び出すことができるため、スクリプト可能関数内で引数を検証する必要があります。のtypeフィールドは、この検証の適切な候補です。

例:

color: function(context) {
    const index = context.dataIndex;
    const value = context.dataset.data[index];
    return value < 0 ? 'red' :  // draw negative values in red
        index % 2 ? 'blue' :    // else, alternate values in blue and green
        'green';
},
borderColor: function(context, options) {
    const color = options.color; // resolve the value of another scriptable option: 'red', 'blue' or 'green'
    return Chart.helpers.color(color).lighten(0.2);
}

#インデックス可能なオプション

インデックス可能なオプションは、各項目が同じインデックスの要素に対応する配列も受け入れます。データより項目が少ない場合、項目がループされることに注意してください。多くの場合、関数サポートされている場合は、より適切です。

例:

color: [
    'red',    // color for data at index 0
    'blue',   // color for data at index 1
    'green',  // color for data at index 2
    'black',  // color for data at index 3
    //...
]

#オプションのコンテキスト

オプション コンテキストは、オプションを解決するときにコンテキスト情報を提供するために使用され、現在はのみに適用されます。スクリプト可能なオプション。 オブジェクトは保存されるため、呼び出し間で情報を保存したり渡したりするために使用できます。

コンテキスト オブジェクトには複数のレベルがあります。

  • chart
    • dataset
      • data
    • scale
      • tick
      • pointLabel(ラジアルリニアスケールでのみ使用)
    • tooltip

各レベルはその親を継承し、親に保存されているコンテキスト情報は子を通じて利用できます。

コンテキスト オブジェクトには次のプロパティが含まれます。

#チャート

  • chart: 関連するチャート
  • type:'chart'

#データセット

に加えてチャート

  • active: 要素がアクティブ (ホバーされている) の場合は true
  • dataset: インデックスのデータセットdatasetIndex
  • datasetIndex: 現在のデータセットのインデックス
  • index: と同じdatasetIndex
  • mode: アップデートモード
  • type:'dataset'

#データ

に加えてデータセット

  • active: 要素がアクティブ (ホバーされている) の場合は true
  • dataIndex: 現在のデータのインデックス
  • parsed: 指定されたデータの解析されたデータ値dataIndexdatasetIndex
  • raw: 指定されたデータの生データ値dataIndexdatasetIndex
  • element: このデータの要素 (点、円弧、バーなど)
  • index: と同じdataIndex
  • type:'data'

#規模

に加えてチャート

  • scale: 関連するスケール
  • type:'scale'

#カチカチ

に加えて規模

  • tick: 関連するティックオブジェクト
  • index: ティックインデックス
  • type:'tick'

#ポイントラベル

に加えて規模

  • label: 関連付けられたラベル値
  • index: ラベルインデックス
  • type:'pointLabel'

#ツールチップ

に加えてチャート

  • tooltip: ツールチップオブジェクト
  • tooltipItems: ツールチップが表示している項目
最終更新: 2023 年 4 月 28 日、午前 5 時 18 分 20 秒